home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 011 / sd22.arc / SD22.DOC < prev   
Text File  |  1987-05-21  |  7KB  |  140 lines
  1.  
  2.  
  3. Introduction
  4.  
  5.      Switch Directory (SD) is a utility that allows you to easily switch
  6.      between subdirectories and drives with a minimum of typing.  All you
  7.      need to do is type SD and the name of the drive/subdirectory you desire
  8.      to go to and SD takes you there.  If you have made a mistake, hitting
  9.      Ctrl-Brk will break you out of the program and put you back in the
  10.      subdirectory you started in.  With version 2.1 SD will also except the
  11.      full path designation and quickly switch to the specified path without
  12.      searching.
  13.  
  14. Usage
  15.  
  16.  
  17.       [d:\....]>SD [drive][switch][subdirectory name]
  18.  
  19.                            [drive] - the drive to search (if not searhing
  20.                                      current drive)
  21.  
  22.                            [switch] = blank - search whole disk
  23.  
  24.                                     = \ - search only subdirectories of the
  25.                                           current directory (if no other \
  26.                                           in subdirectory name)
  27.  
  28.                                     = / - search only one path deep. Searches
  29.                                           the root directory only. (Similar
  30.                                           to DOS CD command with one pathname)
  31.  
  32.  
  33.  
  34.                            [subdirectory name] - the name of an individual
  35.                                                  subdirectory or a complete path
  36.  
  37.                            If the command line is left blank then you are
  38.                            taken to the root directory of the disk
  39.  
  40.  
  41.  
  42.                            ? - shows help screen
  43.  
  44.                            If the command line is left blank then you are
  45.                            taken to the root directory of the disk
  46.  
  47. Examples
  48.  
  49.       SD d:             - changes the active drive to d: and puts you
  50.                           in the root directory
  51.  
  52.       SD /source        - searches the root directory of the current drive
  53.                           for a subdirectory named source and puts you in
  54.                           in it (if found)
  55.  
  56.       SD \source        - searches the current directory for subdirectories
  57.                           named source and puts you in the first one it finds
  58.                           NOTE: This is different than the DOS CD command which
  59.                           would search the root dir with this syntax.
  60.  
  61.  
  62.       SD \turbo\source  - changes the current directory to \turbo\source.
  63.                           This is the same as the DOS CD command.
  64.  
  65.       SD source         - searches the current drive for a subdirectory named
  66.                           source and puts you in the first one it finds
  67.  
  68.       SD d:source       - changes the current drive to d and searches that
  69.                           drive for a subdirectory named source and puts you
  70.                           in the first one it finds.
  71.  
  72.       SD d:\source      - searches the current directory of the specified
  73.                           drive for subdirectories named source and puts
  74.                           you in the first one it finds
  75.  
  76.       SD d:\turbo\source- changes the current drive to the drive specified
  77.                           then puts you in the specified directory
  78.                           This is the an enhanced version of the DOS CD
  79.                           command that lets you specify the drive as well
  80.                           as the specific path.
  81.  
  82. Caveats and Other Things
  83.  
  84.      Caveats first.  If you have duplicate subdirectory names SD will
  85.      drop you in the first one it finds.  SD will only search the drive
  86.      that is specified.  If you have a large number of subdirectories with
  87.      a lot of depth SD could take a few seconds to find its way; be patient,
  88.      such is the price of progress.  Of course, with the source code
  89.      included, you could try and improve the search and speed it up.  Any
  90.      improvements to the code would be welcomed.  The source was derived
  91.      from Vern Buerg's sorted directory program, LDIR and WHISK by Charles
  92.      Wooster.  Thanks guys.  It is written for the A86 assembler.
  93.      This shouldn't be a problem for anyone who is using MASM.
  94.  
  95.      If you have any comments, suggestions or bug reports drop me
  96.      a line on Bob Blacher's Computer Connection in DC.
  97.  
  98.                                                     Stephen Falatko
  99.  
  100.  
  101.  
  102. Update Notes
  103.  
  104.      Version 1 - 3/12/87
  105.  
  106.      Version 1.1 - 3/18/87  Bug fix.  An error in the routine that creates
  107.                             a full path name for use in actually setting
  108.                             path would preclude switching to directories
  109.                             whose depth was greater than 2 deep.
  110.  
  111.      Version 2.0 - 5/15/87  Changed the path search routine.  Added new
  112.                             features, the / and \ switches to search one path
  113.                             deep and search only subdirectories of the current
  114.                             directory respectively.  This provides a means to
  115.                             refine the searching and provide more speed.  You
  116.                             can now search other drives by specifying a drive
  117.                             on the command line.  Added break out feature so
  118.                             that hitting Ctrl-Brk will place you in your
  119.                             original directory.
  120.  
  121.      Version 2.1 - 5/19/87  Jack Kilday, sysop of Northern Lights in Maine,
  122.                             suggested that the capability to designate a
  123.                             specific path be added to SD.  This has been added.
  124.                             SD recognizes a full path on the command line
  125.                             (by seeing two or more '\' characters)
  126.                             and instead of searching the entire disk for the
  127.                             subdirectory explicitely changes to the desired
  128.                             path.  NOTE: One difference between SD and the
  129.                             DOS CD command: CD\subdir will check the root
  130.                             directory for the subdirectory, SD \subdir will
  131.                             check only subdirectories of the current directory
  132.                             for the desired subdir.  To check only the root
  133.                             directory you must use SD /subdir.
  134.  
  135.      Version 2.2 - 5/21/87  Bug fix.  If you tryed to change directories and
  136.                             used a capital drive specifier the program changed
  137.                             it to lower case which DOS doesn't like and the
  138.                             drive was not changed.
  139.  
  140.